home *** CD-ROM | disk | FTP | other *** search
/ Megarom / Megarom Macintosh CD Software (Quantum Leap)(1992).iso / CDEV⁄RDEV / Notify 2.2 / Notify 2.2 Doc < prev   
Text File  |  1992-04-18  |  8KB  |  149 lines

  1.  
  2.  
  3.  
  4.  
  5. Version 2.2
  6.  
  7.      Who remembers to look at calendars?  I have to put something on the Mac to make sure I'm going to see it.
  8.  
  9.      Yes, there is already software available to do this, but again, if you are like me, you can’t afford an expensive product that you will never use 90% of.  Thus, the Notify system, which uses a Control Panel for a user interface and, for posting messages, uses the same Macintosh Notification Manager that most people first met as “Print Monitor has a problem printing.  Please bring Print Monitor to the front.”
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.      Since it depends on the Notification Manager, Notify will run only in System 6.0 or later.  In order to use Notify, it must be placed in the System Folder for System 6.0.x or the Control Panels folder for System 7, and then the Mac must be rebooted.
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.      When the Notify Control Panel is first opened, the display looks like the above.  The “Edit” and “Delete” buttons are active only when a message is selected in the list, in which case the “Edit” button is the default rather than “New”.
  40.      If there are any messages in the list, they may be selected either by clicking on them, or by typing the up or down arrows.
  41.      To enter a new message, select the “New” button.
  42.      The “Show startup icon” checkbox controls whether the Notify icon will be displayed as Notify is installed at system startup time.
  43.  
  44. Keyboard shortcuts—
  45.     <Return> or <Enter> selects the outlined button, either “New” or “Edit.”
  46.     <N> (without the Command key) will always select the “New” button.
  47.  
  48.  
  49. New Messages:
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Upon selecting the “New” button, the above dialog is displayed.  “Date” and “Time” designate the first time the message is to be displayed.  The time may be entered in 12 or 24 hour.  (Seconds are ignored if entered.)
  71.      Note that messages are restricted to 240 characters.  This is because the Macintosh Notification Manager will only display 255 characters, and Notify reserves some of them to display the date and time of the message.
  72.      The Return key is significant within the message text.  <Command-X>, <Command-C>, and <Command-V> have their normal clipboard interaction of Cut, Copy, and Paste.  In System 7, these commands are also accessible from the Finder’s Edit menu.
  73.      The rectangle labeled “Don’t Repeat” is a pop-up menu with the choices “Don’t Repeat,” “Repeat Daily,” “Repeat Weekly,” “Repeat Monthly,” “Repeat Annually,” and “Repeat Every…”  Selecting an item on this menu designates how often the message should be displayed.  If “Repeat Every…” is selected, new text items are displayed to allow the the exact repeat interval—in days, hours, and minutes—to be typed in.
  74.      The two radio buttons in the upper right corner, along with the list below them, designate the sound that will accompany the message when it is displayed.  Selecting the “Default Beep” button uses the default system beep sound, or selecting any name from the list will use that sound.  Selecting the “Silent” button uses no sound at all.
  75.      Messages are ordinarily displayed at the exact time for which they are scheduled, but when the Mac is powered up, there may be a backlog of messages overdue to be displayed.  The “Timeout” checkbox designates that a message that is too old to be of significance should be discarded instead of displayed.  The items to the right of the checkbox allow the meaning of “too old” to be specified.
  76.      Clicking the “Cancel” button discards the message and returns to the Control Panel.
  77.      To store the message, click the “Save” button.  For convenience, when the dialog comes up, “Date” and “Time” will contain the current date and time, but the Save command will not exit the dialog unless they are changed to designate at least one minute into the future.
  78.      If the “Save defaults” checkbox is checked when the message is saved, the selected Repeat interval, Timeout interval, and sound will be saved as defaults for subsequent new messages.
  79.  
  80. Keyboard shortcuts—
  81.     <Command-Period> or <Escape> selects the “Cancel” button.
  82.     <Command-S> selects the “Save” button.
  83.     <Command-T> toggles the “Timeout” checkbox.
  84.     <Command-1> selects “Don’t Repeat” from the pop-up menu.
  85.     <Command-2> selects “Repeat Daily.”
  86.     <Command-W> selects “Repeat Weekly.”
  87.     <Command-M> selects “Repeat Monthly.”
  88.     <Command-A> selects “Repeat Annually.”
  89.     <Command-E> selects “Repeat Every…”
  90.  
  91.  
  92. Editing Existing Messages:
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.      To edit an existing message, or just to view the entire text of the message, select the message in the Control Panel display, then click on the “Edit” key.  The same dialog will be displayed as for the “New” command, except that the “Delete” button will be active.  To store the changed message, click the “Save” button.  Clicking “Delete” (or typing <Command-D>) will remove the message from the system.  Just as in the “New” command, checking the “Save defaults” checkbox will save information in the defaults.
  114.      The Edit command is also invoked by double-clicking on the message in the Control Panel.
  115.  
  116.  
  117. Deleting Messages:
  118.  
  119.      To remove a message, select it in the Control Panel display and click the “Delete” button (in System 6.0.x, <Command-D> is equivalent to this button).  Or you can look at the entire message, then use the Edit dialog’s “Delete” button as mentioned above.
  120.  
  121.  
  122. Notes:
  123.  
  124. 1.  The maximum number of messages that can be in the system at any one time is 64 (up from a previous 32).
  125. 2.  Message text is stored in the data fork of the Notify control panel file.  The application “Copy Notify” will copy messages from one Notify file to another.
  126.  
  127.  
  128.      How much would you pay for a program that does all of that?  $19.95?  But wait!  That’s not all!  It’s compact and efficient too!  It only consumes 28 to 35K of your disk and 5K of your System heap, and steals virtually no time from other programs!  Now what would you pay?  $29.95?  Or $44.95 with Ginsu knives?
  129.      No way!  This is freeware.  (And sorry, but the knives are not included.)  That means that I don’t intend to make any money on it, but I retain copyright and don’t want anyone else making money on it either.
  130.      Personally, I would think that having someone to remind me of every little thing would be worth mega.  [Hey, we ARE allowed to dream, aren’t we?]
  131.  
  132. Steve Stockman
  133. 1325 W. Bewick
  134. Fort Worth TX  76110
  135. 817-924-9256
  136. CI$: 76507,2646
  137.  
  138. Source code available for anyone who cares.  (122K normal, 41K Stuffed.  Please send CI$ ID, or a dollar, or a blank disk with SASE.)
  139.  
  140. Version History:
  141. 1.0  Original.  (Lightspeed C 3.0)
  142. 1.1  Worked some bugs out.
  143. 1.2  Moved from 7-crashy to 7-friendly, including Balloon Help on Control Panel.  (Think C 4.0.5)
  144. 2.0  Added sounds, added Repeat menu, associated timeouts with individual messages, restructured message scheduling so that it steals much less time.  (Think C 5.0)
  145. 2.0.1  Got Balloon Help working in the Message Editor.  (Think C 5.0.1)
  146. 2.1  Restructured message allocation so that it is much easier to change the maximum number of messages, now at 64.  Also pulled some things out of resources and into program data to cut down on system heap usage.  Built “Copy Notify” utility application.  (Think C 5.0.1)
  147. 2.1.1  Fixed the delay so that Notify will be touched every five minutes.  (Think C 5.0.1)
  148. 2.1.2  Invoked International Utilities for handling dates and times in accordance to local preferences.  Also fixed two bugs:  a) deleting the last message in the file could cause an end-of-file error later; b) display update sometimes got Address Error bomb on 68000 Macs.  [Hey, I’ve only had 020’s and 030’s for five years!  No such animal as Address Error.]  (Think C 5.0.2)
  149. 2.2  Added “Save defaults” checkbox to Message Editor.  Also, fixed a problem with preferences sometimes not being saved.  (Think C 5.0.2)